addhostport
addhostport コマンドは、既存のホスト・オブジェクトにワールド・ワイド・ポート名 (WWPN)、Internet Small Computer System Interface (iSCSI) 名、または NVMe 修飾名 (NQN) を追加するために使用します。
構文
パラメーター
- -saswwpn wwpn_list
- (-iscsiname、-fcwwpn、または -nqn を使用しない場合は必須。) 16 文字の 16 進数ストリングで、Serial Attached SCSI (SAS) WWPN のリストを指定します。
- -fcwwpn wwpn_list
- (-iscsiname、-saswwpn、または -nqn を使用しない場合は必須。) 16 文字の 16 進数ストリングでファイバー・チャネル (FC) WWPN のリストを指定します。
- -iscsiname iscsi_name_list
- (-fcwwpn、-saswwpn、または -nqn を使用しない場合は必須。) ホストに追加する iSCSI 名のコンマ区切りリストを指定します。少なくとも 1 つの WWPN または iSCSI 名が指定されている必要があります。このパラメーターは、-fcwwpn または -saswwpn パラメーターと一緒に使用することはできません。
- -nqn nqn_list
- (-fcwwpn、-saswwpn、または -iscsiname を使用しない場合は必須。) ホストに追加する NVMe 修飾名 (NQN) のコンマ区切りリストを指定します。このパラメーターを使用するには、ホスト・プロトコルが nvme でなければなりません。
- -force
- (オプション) WWPN または iSCSI 名の妥当性検査を行わずに、ポートのリストをホストに追加することを指定します。
- host_id | host_name
- (必須) ポートの追加先のホスト・オブジェクトを ID または名前のいずれかで指定します。
説明
このコマンドは、ホスト・バス・アダプター (HBA) WWPN、iSCSI 名、または NQN のリストを、指定されたホスト・オブジェクトに追加します。このホスト・オブジェクトにマップされたボリュームは、すべて自動的に新規ポートにマップされます。
注: ホスト・ポートは、ホストのプロトコルと互換性がある場合にのみ追加することができます (SCSI は NQN を除くすべてのポート・タイプを持つことができ、NVMe は NQN のみを持つことができます)。
ログイン済みで未構成の WWPN のみを追加することができます。候補 WWPN のリストについては、lssasportcandidate または lsfcportcandidate コマンドを使用します。
一部の HBA デバイス・ドライバーは、ターゲットの論理装置番号 (LUN) を認識できるまではファブリックにログインしません。ログインしないため、それらの WWPN は候補ポートとして認識されません。force パラメーターを addhostport コマンドと一緒に指定して、WWPN リストの妥当性検査を停止することができます。
注: すべての入出力グループが iSCSI ホストから削除されている場合は、iSCSI ホストを少なくとも 1 つの入出力グループにマップするまでは、iSCSI ホストにポートを追加することはできません。iSCSI ホストを少なくとも 1 つの入出力グループにマップした後、addhostport コマンドを再実行依頼します。ポートをホストに追加した後、chhost コマンドを使用してホスト認証エントリーを作成する必要があります。
以下の場合、addhostport コマンドは失敗します。
- ホストが、アクセス・セット内に複数の入出力グループを持つボリュームにマップされている。また、追加するホスト・ポートが Internet Small Computer System Interface (iSCSI) 名である。
- 追加されるポートが、複数の入出力グループからマップされるボリュームをサポートしないホスト・システムからのものである。
呼び出し例
addhostport -saswwpn 210100E08B251DD4 host1結果出力:
No feedback呼び出し例
addhostport -fcwwpn 210100E08B251EE6 host1結果出力:
No feedback呼び出し例
addhostport -iscsiname iqn.localhost.hostid.7f000001 mchost13結果出力:
No feedback